home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr34 / zap125.zip / ZAP.DOX < prev    next >
Text File  |  1995-01-31  |  5KB  |  94 lines
  1. ZAP Documentation:
  2.  
  3. ZAP, which stands for Zip Archive Processor, is an archive scanning utility.
  4. It is intended to easily and quickly perform some very common tasks that many
  5. users who upload or download often will usually perform by hand.
  6.  
  7. ZAP is a shell utility, meaning it does not actually perform the operations
  8. by itself.  Rather, ZAP uses three other utilities:  RECOM, STRIPAV, and
  9. PKZIP.  These utilities are required for operation.  In addition, DOS 5.0 or
  10. later is also needed.  RECOM v1.05 and STRIPAV archives are included with
  11. this file bundle in case you do not already have them.  PKZIP 2.0x is not
  12. included, but should be available on any major BBS in your area.  These
  13. three utilities must be located somewhere in the PATH of your computer.
  14.  
  15. ZAP's operations are:
  16.  
  17.   o  Strips out -AV (Authenticity Verification) codes.                   /AV
  18.   o  Removes/replaces the zipfile comment with your own.                /CMT
  19.   o  Removes unwanted files (BBS ads, etc.) which you choose.           /ADS
  20.   o  Checks the zipfile for integrity.                                  /CRC
  21.   o  Replaces the FILE_ID.DIZ file with a file of your choice.          /DIZ
  22.  
  23. ZAP is only a command-line utility.  All operations can be selected by simply
  24. passing the appropriate parameter (see above list).  You simply pass ZAP the
  25. options you want, and multiple filespecs for which zipfiles you want checked.
  26. ZAP defaults to all operations except .DIZ replacement , and a filespec of
  27. "*.ZIP".  For more info just type "ZAP /?" from the command prompt.
  28.  
  29. NOTE:  The /ADS function involves deletion of files from within the .ZIP.
  30. Due to how PKZIP's archives are contructed, this option will take up more
  31. time than *ALL* of the others combined!  This is unavoidable, unfortunately;
  32. so you may wish to only use the /ADS option when you know the file contains
  33. some unwanted files.
  34.  
  35. ZAP's interface is simply - a one line "light bar" which will show you the
  36. current file, possible operations, completed operations, and the operation
  37. currently underway.  Non-selected options will be black.  Currently executing
  38. options will be bright white.  Options which were completed will be grey.
  39. Note:  If the CRC Test encounters an error, the indicator will change to RED
  40. for the length of the operations on that file.  Also, the logfile will
  41. include the error.
  42.  
  43. ZAP handles filespecs very flexibly.  It will handle any DOS-legal filespec
  44. including wildcards and pathnames, and display all files that match it.
  45. Note:  If you want to view the files in a subdirectory off from the
  46. directory you are currently in, you must include a filespec, ie. instead of
  47. "C:\>ZAP DOS" you must use "C:\>ZAP DOS\*.*".  This is due to one of my
  48. libraries, and may change in the future.
  49.  
  50. ZAP uses three files:  ZAP.CMT, ZAP.ADS, and ZAP.LOG.  ZAP.CMT should be an
  51. ASCII file with a comment you would like added to your archives.  If you do
  52. not want any comments, and want ZAP to remove current comments, delete this
  53. file.  Included is a sample comment for your use.  ZAP.ADS is an ASCII file
  54. of filespecs, one per line, of files you want ZAP to delete from your
  55. archives.  Included is a partial list of obnoxious files that I remove when
  56. I get a new zipfile.
  57.  
  58. NOTE:  the longer the ZAP.ADS file, the longer the /ADS function will take to
  59. complete.  Up to about seven filespecs can be deleted from a .ZIP in the same
  60. rough time, however, another 1-7 will double the time.  Ie, 21 filespecs will
  61. take three times the time as 7, etc.  So, if you want speed, you may want to
  62. remove filespecs that are not very common in the archives you run into.
  63.  
  64. Lastly, ZIP.LOG is the error log.  If there were any problems with the
  65. archives tested, ZAP will alert you and display the list.  At each run of
  66. ZAP, the error log will be deleted.  These three files must be in the same
  67. directory that ZAP is located in.
  68.  
  69. Optionally, ZAP will replace the FILE_ID.DIZ file with a file you pass to it
  70. via command-line.  If you do not pass the full pathname of the new .DIZ, ZAP
  71. will look for it in the same directory ZAP.EXE is located in.  Note:  if you
  72. just want ZAP to remove the .DIZs, add FILE_ID.DIZ to the unwanted ads file.
  73.  
  74. Important:  ZAP is FreeWare.  This means you can use it free, without
  75. charge, for however long you find it useful!  You may duplicate it and
  76. distribute it as you wish, but you cannot lawfully change it in any way.
  77. Also, author's permission is needed before bundling it with any commercial
  78. packages.
  79.  
  80. If you notice any bugs or errors, please try to report them to me.  You can
  81. reach me at any one of the below systems.  Any suggestions for new features
  82. will be enthusiastically considered, and time/skill permitting, implemented.
  83.  
  84. Thanks!
  85.  
  86.  
  87. Rick Lotter
  88.  
  89. ┌──────────────────────────────┐
  90. │  Exec-PC: Rick Lotter        │
  91. │      AOL: RikLotter          │
  92. │ Internet: rlotter@execpc.com │
  93. └──────────────────────────────┘
  94.